Release 10.1A: OpenEdge Development:
Progress Dynamics Web Development Guide


Information (info)

Information (info) actions apply to the Messages frame in the default HTML page layout.

The following table lists and describes the info actions:

Action
Description
info.alert|short|long|arg, arg, ... 
Adds a message to the status window with an alert.
info.clear 
Clears the messages in the info object.
info.confirm|short|long|action|arg, arg, ... 
Asks for user confirmation. If OK, then runs action.
info.field|short|long|field|arg, arg, ... 
Marks a field for error and displays a message.
info.msg|short|long|arg, arg, ... 
Adds a message to the status window.
info.prompt|short|long|action|arg, arg, ... 
Asks for user input, then runs action.
info.yesno|short|long|yes-action|no-action|
cancel-action 
Creates a nonmodal dialog box that requires user response. Runs the first action (yes-action) if the user chooses Yes. Runs the second action (no-action) if the user chooses No. Quits if the user chooses Cancel.
main.info.hide 
Hides the info object.
main.info.load([short|long, short|long ...]) 
Loads indexed messages.
main.info.show 
Shows the info object.

Info Action Parameters
short

A character string that specifies a brief version of a message.

Can also be used as an index to look up messages stored in the information object. Use as an index requires:

long

A character string that specifies a more detailed version of a message than the short character string.

The character string can optionally contain substitution arguments in the form &n, where n is an integer between 1 and 9 inclusive. Substitutions are performed based on the values specified in the arg parameter.

field

The field name qualified by an SDO name (sdo_name.field_name).

arg, arg, ...

A comma-separated list of constants, field names, variables, or expressions that results in a character string value. These argument values replace substitution parameters in long.

Note: The pipe character (|) is used to separate parameters. See the following example.

Example

This example creates an error message for the state field while validating a customer record:

apph.action("info.field|code invalid|The &1 code needs to be a valid two 
character US State abbreviation|customer.state"); 


Copyright © 2005 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095